home *** CD-ROM | disk | FTP | other *** search
/ Acorn RISC PD-CD 1 / Acorn RISC PD-CD 1.iso / languages / dde / _pc / h / fontselect < prev    next >
Text File  |  1992-02-09  |  4KB  |  108 lines
  1. (*
  2.  * Title: fontselect.h
  3.  * Purpose: Consistent interface to font choosing
  4.  *
  5.  *)
  6.  
  7. #ifndef __fontselect_h
  8. #define __fontselect_h
  9.  
  10. type fontselect_fn = ^function fontselect(font_name : string;
  11.                                        width, hieght : real;
  12.                                        event : wimp_eventstr_ptr) : boolean;
  13.  
  14. (* --------------------------- fontselect_init -----------------------------
  15.  * Description:   Read in the font list and prepare data for the font
  16.  *                selector window
  17.  *
  18.  * Parameters:
  19.  * Returns:       TRUE if initialisation succeeded.
  20.  * Other Info:
  21.  *)
  22. function fontselect_init : integer; extern;
  23.  
  24.  
  25. (* ------------------------ fontselect_closedown --------------------------
  26.  * Description:   Close the font selector windows if they are open, and
  27.  *                free the font selector data structures
  28.  *
  29.  * Parameters:
  30.  * Returns:
  31.  * Other Info:    This call is provided to return the machine to the state
  32.  *                it was in before a call of fontselect_init()
  33.  *)
  34. procedure fontselect_closedown; extern;
  35.  
  36.  
  37. (* ------------------------ fontselect_closewindows -----------------------
  38.  * Description:   Close the font selector windows if they are open
  39.  *
  40.  * Parameters:
  41.  * Returns:
  42.  * Other Info:    This call will close the font selector windows and
  43.  *                unattach the handlers, if they are open.
  44.  *)
  45. procedure fontselect_closewindows; extern;
  46.  
  47.  
  48. (* ------------------------ fontselect_selector ---------------------------
  49.  * Description:   Opens up or reopens the font chooser window.
  50.  *
  51.  * Parameters:    char *title                -- The title for the window
  52.  *                                              (can be NULL if flags
  53.  *                                              SETTITLE is clear)
  54.  *                int flags                  -- The flags for the call
  55.  *                                              (see below)
  56.  *                char *font_name            -- The font name to set the
  57.  *                                              window contents to (only if
  58.  *                                              SETFONT is set)
  59.  *                double width               -- The width in point size of
  60.  *                                              the font
  61.  *                double height              --
  62.  *                fontselect_fn unknown_icon --
  63.  * Returns:       The window handle of the font selector main window, if
  64.  *                the function call was successful. Otherwise it returns 0.
  65.  * Other Info:    The flags word allows the call to have different effects.
  66.  *                    If fontselect_SETFONT is set then the window contents
  67.  *                    will be updated to reflect the font choice passed in.
  68.  *                    If fontselect_SETTITLE is set then the title of the
  69.  *                    window will be set, otherwise title is ignored.
  70.  *                    If fontselect_REOPEN is set then the font selector
  71.  *                    will only open the window if it is already open. This
  72.  *                    lets the application update the contents of the window
  73.  *                    only if it is currently open.
  74.  *                Note that the fontselect_init() must be called before this
  75.  *                routine.
  76.  *)
  77. function fontselect_selector(title : string;
  78.                 flags : integer;
  79.                 font_name : string;
  80.                 width, height : real;
  81.                 unknown_icon_routine : fontselect_fn) : integer; extern;
  82.  
  83. const   fontselect_REOPEN    = $001;
  84.         fontselect_SETTITLE  = $002;
  85.         fontselect_SETFONT   = $004;
  86.  
  87.  
  88. (* ------------------------- fontselect_attach_menu ------------------------
  89.  * Description:   Attaches a menu to all four font selector windows
  90.  *
  91.  * Parameters:    menu mn                        -- menu to attach
  92.  *                event_menu_proc menu_processor -- menu processor for the
  93.  *                                                  menu events
  94.  *                void *handle                   -- handle to pass to the
  95.  *                                                  menu processor
  96.  * Returns:       TRUE if the menus were attached, FALSE otherwise
  97.  * Other Info:    none.
  98.  *)
  99. function fontselect_attach_menu(mn : menu;
  100.                 menu_processor : event_menu_proc;
  101.                 handle : pointer) : boolean; extern;
  102.  
  103.  
  104. #endif
  105.  
  106.  
  107. (* end fontselect.h *)
  108.